chhost
Use o comando chhost para alterar o nome ou tipo de um objeto do host. Esse comando não afeta nenhum mapeamento de host existente.
Sintaxe
Paramêtros
- -type hpux | tpgs | generic | openvms | adminlun | hide_secondary
- (Opcional) Especifica o tipo do host. Os valores a seguir são os tipos de hosts disponíveis:
genericindica o padrão.tpgsindica quando as informações da porta de destino mudam (são dadas atenções extras da unidade ao host).openvmsindica OpenVMS.adminlunindica volumes virtuais, que são ativados no host.hpuxindica o firmware HP-UX.hide_secondaryindica que todos os volumes secundários de relacionamento de cópia remota estão indisponíveis para o host.
O tipo de host para hosts NVMe não pode ser mudado. Para obter informações adicionais sobre hosts que requerem o parâmetro type, consulte a documentação de conexão de host do IBM Spectrum Virtualize for Public Cloud .
- -name new_name_arg
- (Opcional) Especifica o novo nome que você deseja designar para o objeto do host.
- -protocol scsi | nvme
- (Opcional) Especifica o protocolo que é usado pelo host para se comunicar com o sistema de armazenamento. O padrão é scsi. O host -protocol
não pode ser mudado ao mesmo tempo que o host -type. O protocol de um
host pode ser mudado apenas se os seguintes itens forem verdadeiros:
- Nenhum volume é mapeado para o host.
- Nenhuma porta está definida no host.
- O tipo de host é compatível com o novo protocolo. Um host que usa o protocolo NVMe deve ser do tipo generic.
- -mask port_login_mask
- (Opcional) Especifica quais portas de destino do nó um host pode acessar e a máscara de porta do Fibre Channel (FC)
para o host. Os nomes da porta universal (WWPNs) no objeto do host devem acessar volumes a partir das portas de nó que são incluídas na máscara e que estão no grupo de E/S do objeto do host. A máscara de porta é um binário de 64 bits e é composta de uma combinação de números 0 e 1, em que 0 indica que a porta de E/S do FC correspondente não poderá ser usada e 1 indica que poderá. O bit mais à direita na máscara
corresponde à porta de E/S FC 1. Os valores de máscara válidos vão de 0000
(nenhuma porta ativada) a
1111111111111111111111111111111111111111111111111111111111111111 (todas as
portas ativadas). Por exemplo, uma máscara 111111101101 ativa as portas 1, 3, 4, 6, 7, 8, 9, 10, 11 e 12.
Atenção: Mudar a máscara da porta do host pode resultar em uma perda de acesso. Antes de desativar portas, verifique se o host tem acesso a outras portas.
- -iscsiusername username_for_authentication
- (Opcional) Especifica o nome do usuário para um objeto host para autenticação unilateral para login de conexão de host do Small Computer System Interface (iSCSI). Se esse parâmetro for especificado, o valor será obtido como o "username" para autenticação unilateral para efetuar login na conexão de host do iSCSI. Se você não especificar o parâmetro iscsiusername, o IQN do objeto do host será usado como o nome do usuário por padrão. Se nenhum parâmetro iscsiusername for fornecido e existirem vários IQNs no mesmo objeto do host, o nome de usuário de cada IQN será o próprio IQN. Se o parâmetro iscsiusername for fornecido para um host de IQNs múltiplos, efetue login em todos os hosts usando o IQN fornecido. Se você usar o parâmetro iscsiusername, deve-se também especificar o parâmetro chapsecret.
- -chapsecret chap_secret
- (Opcional) Configura o segredo do Challenge Handshake Authentication Protocol (CHAP) que é usado para autenticar o host para a E/S do iSCSI. Esse segredo é compartilhado entre o host e o cluster. O segredo do CHAP para cada host pode ser listado usando o comando lsiscsiauth.
- -nochapsecret
- (Opcional) Limpa qualquer segredo do CHAP configurado anteriormente para este host. O parâmetro nochapsecret não poderá ser especificado se chapsecret estiver especificado.
- -site site_name | site_id
- (Opcional) Especifica o valor do site numérico ou o nome do site do
host. O nome do site deve ser um valor alfanumérico. O ID do site deve ser
1ou2. O site designado a um host pode ser mudado com qualquer topologia: (hyperswap,stretchedoustandard).Nota: Se o host for mapeado para um volume que esteja em um relacionamento ativo/ativo (HyperSwap), não será possível especificar -nosite. - -nosite
- (Opcional) Reconfigura o valor do site.
- host_name | host_id
- (Obrigatório) Especifica, por ID ou pelo nome atual, o objeto de host a ser modificado.
Description
Esse comando pode alterar o nome do host especificado para um novo nome ou pode alterar o tipo de host. Esse comando não afeta nenhum dos mapeamentos de host atual.
A máscara da porta aplica-se a logins da porta do inicializador do host associados ao objeto de host. Para cada login entre uma porta do adaptador de barramento de host (HBA) e uma porta de nó, o nó examina a máscara da porta que está associada ao objeto do host para o qual o HBA de host é um membro e determina se o acesso é permitido ou negado. Se o acesso for negado, o nó responderá aos comandos SCSI como se a porta fosse desconhecida.
Um exemplo de chamada
chhost -name testhostlode -mask 111111101101 hostone
A seguinte saída é exibida:
Sem feedbackUm exemplo de chamada
chhost -type openvms 0
A saída a seguir é exibida:
Sem feedback
Um Exemplo de Chamada
chhost -site site1 host3A seguinte saída é exibida:
Sem feedback
